XMLSocket.onXML

Доступность

Flash Player 5.

Синтаксис

myXMLSocket.onXML = function(object:XML) {
  // необходимый код
}

Parameter

object Объект XML, содержащий отпарсированный XML документ, полученный с сервера.

Возвращает

Ничего.

Описание

Обработчик события; вызывается Flash Player когда определенный объект XML, содержащий XML документ, получен по XMLSocket соединению. XMLSocket соединение может использоваться для передачи любого числа XML документов между клиентом и сервером. Каждый документ завершается нулевым байтом (0). Когда Flash Player получает нулевой байт, он парсирует все XML данные, полученные с момента фиксирования прошлого нулевого байта или, если это первое сообщение, установки соединения. Каждая полученная часть XML рассматривается как отдельный XML документ и передается обработчику onXML.

По умолчанию данный обработчик не выполняет действий. Чтобы определить исполняемые им функции, необходимо присвоить ему значение переменной-функции.

Пример

Следующая функция переопределяет обработчик onXML, реализуя простое чат-приложение. Функция myOnXML получает единственный XML элемент, MESSAGE, в следующем формате:

<MESSAGE USER="John" TEXT="Hello, my name is John!" />. 
var socket:XMLSocket = new XMLSocket();

Следующая функция displayMessage() отображает сообщение, полученное пользователем:

socket.onXML = function (doc) {
  var e = doc.firstChild;
  if (e != null && e.nodeName == "MESSAGE") {
    displayMessage(e.attributes.user, e.attributes.text);
  }
}

См. также

function

Посмотреть комментарии LiveDocs

Предыдущая | Следующая | Оглавление